home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xt / XtRealizeWidget.z / XtRealizeWidget
Encoding:
Text File  |  2002-10-03  |  4.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXttttRRRReeeeaaaalllliiiizzzzeeeeWWWWiiiiddddggggeeeetttt((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttRRRReeeeaaaalllliiiizzzzeeeeWWWWiiiiddddggggeeeetttt((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtRealizeWidget, XtIsRealized, XtUnrealizeWidget - realize
  10.           and unrealize widgets
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           void XtRealizeWidget(_w)
  14.                 Widget _w;
  15.  
  16.           Boolean XtIsRealized(_w)
  17.                 Widget _w;
  18.  
  19.           void XtUnrealizeWidget(_w)
  20.                 Widget _w;
  21.  
  22.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  23.           _w         Specifies the widget.
  24.  
  25.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.           If the widget is already realized, _X_t_R_e_a_l_i_z_e_W_i_d_g_e_t simply
  27.           returns. Otherwise, it performs the following:
  28.  
  29.           +o    Binds all action names in the widget's translation
  30.                table to procedures (see Section 10.1.2).
  31.  
  32.           +o    Makes a post-order traversal of the widget tree rooted
  33.                at the specified widget and calls the change_managed
  34.                procedure of each composite widget that has one or more
  35.                managed children.
  36.  
  37.           +o    Constructs an _X_S_e_t_W_i_n_d_o_w_A_t_t_r_i_b_u_t_e_s structure filled in
  38.                with information derived from the _C_o_r_e widget fields
  39.                and calls the realize procedure for the widget, which
  40.                adds any widget-specific attributes and creates the X
  41.                window.
  42.  
  43.           +o    If the widget is not a subclass of
  44.                _c_o_m_p_o_s_i_t_e_W_i_d_g_e_t_C_l_a_s_s, _X_t_R_e_a_l_i_z_e_W_i_d_g_e_t returns;
  45.                otherwise, it continues and performs the following:
  46.  
  47.                -    Descends recursively to each of the widget's
  48.                     managed children and calls the realize procedures.
  49.                     Primitive widgets that instantiate children are
  50.                     responsible for realizing those children
  51.                     themselves.
  52.  
  53.                -    Maps all of the managed children windows that have
  54.                     mapped_when_managed _T_r_u_e.  (If a widget is managed
  55.                     but mapped_when_managed is _F_a_l_s_e, the widget is
  56.                     allocated visual space but is not displayed.  Some
  57.                     people seem to like this to indicate certain
  58.                     states.)
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttRRRReeeeaaaalllliiiizzzzeeeeWWWWiiiiddddggggeeeetttt((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttRRRReeeeaaaalllliiiizzzzeeeeWWWWiiiiddddggggeeeetttt((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.           If the widget is a top-level shell widget (that is, it has
  75.           no parent), and mapped_when_managed is _T_r_u_e, _X_t_R_e_a_l_i_z_e_W_i_d_g_e_t
  76.           maps the widget window.
  77.  
  78.           The _X_t_I_s_R_e_a_l_i_z_e_d function returns _T_r_u_e if the widget has
  79.           been realized, that is, if the widget has a nonzero X window
  80.           ID.
  81.  
  82.           Some widget procedures (for example, set_values) might wish
  83.           to operate differently after the widget has been realized.
  84.  
  85.           The _X_t_U_n_r_e_a_l_i_z_e_W_i_d_g_e_t function destroys the windows of an
  86.           existing widget and all of its children (recursively down
  87.           the widget tree).  To recreate the windows at a later time,
  88.           call _X_t_R_e_a_l_i_z_e_W_i_d_g_e_t again.  If the widget was managed, it
  89.           will be unmanaged automatically before its window is freed.
  90.  
  91.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  92.           XtManageChildren(3Xt)
  93.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  94.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.